home *** CD-ROM | disk | FTP | other *** search
/ The Business Master (4th Edition) / The Business Master - 4th Edition.iso / files / texttors / vde / vde.ref < prev    next >
Text File  |  1993-06-03  |  82KB  |  1,275 lines

  1.  
  2.  
  3.                                    VDE.REF
  4.                                    -------
  5.                      Reference Manual for the VDE Editor:
  6.                           version 1.7 (03 Jun 1993)
  7.  
  8.                              (c)1987-93, E. Meyer
  9.  
  10.  
  11.  
  12. ================================  CONTENTS  ==================================
  13.  
  14.     (For QUICK START, SYNTAX, GENERAL INFORMATION etc. see the file VDE.DOC)
  15.  
  16.      6.  COMMAND REFERENCE, alphabetically by topic:
  17.             Auto format, Auto indent, Auto number, Auto save, Block commands, 
  18.          Cursor position, Data files, Deleting, Envelopes, Files, 
  19.          Find/replace, Foreign characters, Graphics, Header, Hyphenation, 
  20.          Information, Inserting, Justification, Line spacing, Margins, 
  21.          Matching files, MenuBars, Multiple files, Pagination, Paragraph 
  22.          indent, Place markers, Print preview, Print styles/codes, Printer 
  23.          drivers, Printing, Proportional spacing, Protected mode, Reformat, 
  24.          Ruler line, Run command/shell, Save/exit, Screen controls, Screen 
  25.          size, Spelling check, Splitting files, Tabs, Time/date, Undelete, 
  26.          Upper/lower case, Windows.
  27.  
  28.      7. MACROS.  Explanation and examples of:
  29.             Autoexec macro, Function keys, Function key labels, Key definition 
  30.          files, Macro definition and use, Macro programming, Toggle control, 
  31.          Recording macros.
  32.  
  33.      8. REVIEWS / ABOUT THE AUTHOR.
  34.  
  35.     (For use of the VINST installation utility, see the file VINST.REF.)
  36.  
  37.  
  38. ==========================  6. COMMAND REFERENCE  ============================
  39.  
  40.  
  41. AUTO FORMAT (^OM) -  When on, continuously keeps the paragraph of text you are 
  42.     working on properly formatted (margins and spacing), even as you add to or 
  43.     delete from the line; format changes are implemented instantly.  When off, 
  44.     the manual ^B command can still be used (see REFORMAT).  [Default status 
  45.     can be chosen.]
  46.          Care must be taken in files with mixed formats, as the CURRENT 
  47.     settings of margins and spacing are always used.
  48.          Note that with Auto Format on, certain keystrokes may have additional 
  49.     (or no) effects, due to immediate reformatting afterward; and some 
  50.     operations like Find/Replace may be noticably slower.
  51.  
  52. AUTO INDENT (^OA) -  When on, wordwrap or the [Enter] key will cause the 
  53.     cursor, upon moving to the next line, to indent to match any existing 
  54.     indentation on that line (with insert OFF) or the previous line (with 
  55.     insert ON).  Thus any structured indentation you create is maintained.  
  56.     Useful as a temporary (paragraph) indent, or for outlines, program source 
  57.     code, etc.  Works in all modes, including nondocument.  Note: Indentation 
  58.     must be done with spaces or variable tabs, NOT with hard tabs.
  59.  
  60. AUTO NUMBER (^K#) -  VDE can automatically number items in a list.  Just type 
  61.     a "#" character where each number in sequence should go, for example:
  62.              #.  First item.
  63.              #.  Second item...
  64.     You can then mark the list off as a block (see BLOCK COMMANDS), and use 
  65.     the ^K# command: VDE will insert the numbers (1, 2, etc) in place of the 
  66.     "#" markers.  You will be asked for the starting number; the default is of 
  67.     course 1.  (Once this is done the markers are gone.  For frequently 
  68.     revised lists, leave the "#" markers in the file on disk; use ^K# just 
  69.     before printing, and do not save afterward.)  If auto format (^OM) is on, 
  70.     text will be realigned to compensate for varying length numbers.
  71.  
  72. AUTO SAVE (^KA) -  When on, VDE saves any changes you have made to disk 
  73.     automatically, at regular intervals.  This ensures that you don't lose too 
  74.     much work if you make a mistake, have a power outage, etc.  ^KA lets you 
  75.     set the interval (1 to 255 minutes), or turn this feature off entirely 
  76.     (0).  Just press [Enter] to restore the default, normally 0.  [This can be 
  77.     changed with VINST.]
  78.          If you use auto save, be aware that changes you've made to any file 
  79.     may be saved to disk at any moment.  If you don't want this to occur for 
  80.     a particular file, engage protected mode (^KO).
  81.          Notes: Auto save will wait for an interval when the keyboard is not 
  82.     in use.  It cannot save "untitled" work.  It will make a backup file only 
  83.     if the file had not been saved previously.
  84.  
  85. BLOCK COMMANDS (^KB,^KK,^KH,^KZ,^KY,^KC,^KV,^KW; ^QB,^QK; ^KPB) -  A BLOCK of 
  86.     text is delimited by two markers, set by ^KB (beginning) and ^KK (end), 
  87.     which remain in place until reset elsewhere or deleted.  Alternatively, 
  88.     you can mark a block by moving the cursor to the start or end, holding 
  89.     down the Shift key, and using [^,v,<,>], Home, End], or [PgUp,Dn] to move 
  90.     the cursor to the other end of the block, releasing the Shift key when 
  91.     finished.  In any case, ^KH unmarks the block, removing any marker(s) set.
  92.          The block move and print commands (^KV,^KPB) require a block to be 
  93.     fully marked before use.  To save keystrokes, the other block commands 
  94.     (see also ^K#,^K",AltC), if used when only one block marker is present, 
  95.     will mark the current cursor position as the other end of the block:
  96.          ^KY goes to and deletes the block (including markers).  (If you want 
  97.     to return the cursor to its position before the deletion, type ^QP.)
  98.          ^KV moves the block (including markers) to the present cursor 
  99.     location; ^KC simply copies it, leaving the original marked.  Any place 
  100.     markers present are not transferred.  (The cursor cannot be IN the block.)  
  101.     ^QP may be used to return to the former position of a moved block.
  102.          ^KZ "zooms into" a block: the rest of the text is hidden, and the 
  103.     block is temporarily treated as the entire file.  This can simply isolate 
  104.     one portion of a file for your attention; it can also be done to limit the 
  105.     scope of VDE commands to that portion (only "save" commands like ^KS 
  106.     continue to affect the entire file).  Use ^KZ again to zoom back out.  In 
  107.     zoom mode, pagination is off; you can use block operations, though any 
  108.     block markers within will disappear when you zoom back to the whole file 
  109.     and the original markers are restored.
  110.          ^KW writes the block text to a disk file; you will be asked for the 
  111.     filename (and optional mode).  You can also choose to append the text to 
  112.     an existing file by typing a "+" before the filename, as in:
  113.                       Write to file: +GORT
  114.     (If you don't specify "+", and the file already exists, VDE will ask 
  115.     whether you want to overwrite or append; press [Esc] or [Space] to 
  116.     cancel.)
  117.          ^QB, from wherever you are in the file, moves the cursor to the block 
  118.     start; ^QK moves to the block end.
  119.          ^KPB (^KP with B option) prints the block text only.  (See PRINTING.)
  120.  
  121. CURSOR POSITION (Arrows; ^F,A,C,R; ^QE,X,S,D; ^QR,C; ^QI,L,N,P; AltO) -  VDE 
  122.     supports two sets of arrow keys, which function interchangeably: the four 
  123.     arrow keys [^,v,<,>] on the PC keyboard, and the WordStar "diamond" 
  124.     ^E,^X,^S,^D.  These keys move the cursor one unit up, down, left, and 
  125.     right respectively.  There are many other movement commands as well:
  126.          ^F or ^[>] moves right, to the start of the next word; ^A or ^[<] 
  127.     moves left, to the start of the current (and then previous) word.  ^C or 
  128.     [PgDn] scrolls forward (down) one screen; ^R or [PgUp] scrolls backward 
  129.     (up) one screen.
  130.          Preceded by ^Q, any arrow key moves more Quickly: thus ^QE, ^QX go 
  131.     to the top or bottom of the screen; ^QS, ^QD to the left or right end of 
  132.     the line.  Similarly, ^QR and ^QC scroll all the way to the beginning or 
  133.     end of the file, respectively.
  134.          ^QI moves directly to a given page (for documents) or line (for non- 
  135.     documents).  In documents, ^QL and ^QN move to the start of the Last or 
  136.     Next page, respectively.
  137.          ^QP returns the cursor to its Previous position -- before the last 
  138.     large movement occurred.  (This means AltM,AltO,^B,^QR,^QC,^QF,^QM,^QB, 
  139.     ^QK, and any other command that moves to the block location via ^QB.)  
  140.     After a block move (^KV), ^QP will return to the previous position of the 
  141.     block.  ^QP can be repeated to cycle between two positions in a file.
  142.          AltO displays an Overview bar at the top of the screen.  The length 
  143.     of the bar corresponds to the filesize, and the current position is marked 
  144.     so you can see where you are.  You can move the place marker left or right 
  145.     with the arrow keys; the cursor remains in the original (current) 
  146.     position.  To move to the selected position, press [Enter]; press [Esc] 
  147.     instead to cancel.
  148.  
  149. DATA FILES (AltU) -  AltU allows you to change many VDE settings by using 
  150.     (loading or saving) specific types of data files.
  151.          .VDF/K files can be Loaded and Saved - see KEY DEFINITION FILES.
  152.          .VDG files can be Saved - see GRAPHICS (CHARACTERS).
  153.          .VDP,C,I files can be Loaded - see PRINTER DRIVERS, CHARACTER WIDTHS,
  154.                                         USER OPTIONS.
  155.     Any of these may also be loaded with a semicolon on the command line (see 
  156.     SYNTAX).  Files must be in either the specified, current, or VDE directory 
  157.     (specified with the SET command -- see DIRECTORIES).
  158.          Note: .VDG files can be loaded, and .VDP,C,I files saved, by VINST.  
  159.     In the event that VDE cannot load a data file created by an earlier 
  160.     version, VINST can usually convert it by reading the old file and writing 
  161.     it back to disk in the new format.
  162.  
  163. DELETING (^G,[BkSp],[Del],^T,^[BkSp],^Y; ^QY,^Q[Del],^QT) -  ^G deletes the 
  164.     character at the cursor.  By default, [Del] does the same, while [BkSp] 
  165.     deletes the one to the left.  [But instead, [BkSp] may move nondestruc- 
  166.     tively, and [Del] may delete at the cursor.]
  167.          ^T deletes a word to the right (everything from the cursor to the 
  168.     next word break.)  ^[BkSp] deletes a word to the left.
  169.          ^Y deletes the entire current line.  ^QY deletes just the part of the 
  170.     line to the right of the cursor; ^Q[Del] deletes the part to the left.
  171.          ^QT, followed by a character, deletes everything until the next 
  172.     occurrence of that character.  EXAMPLE: ^QT. (period) deletes to the end 
  173.     of the sentence.  Special cases: ^QT[Enter] deletes to the next HARD CR, 
  174.     the end of the paragraph; ^QT^Z deletes to the end of the file.
  175.          Unintended deletions can be recovered (see UNDELETING).
  176.  
  177. ENVELOPES (^KPA) -  VDE provides an easy way to print a single envelope to 
  178.     accompany a letter, via the "A"ddress option of the print command:
  179.        1.  Begin by moving the cursor to the address of the recipient, and 
  180.     marking this as a block (see BLOCK COMMANDS):
  181.                      {Chester Fludd
  182.                       193 Lakota St         "{}" = block markers
  183.                       Norman, OK  73069}
  184.        2.  Then use the print command (^KP), and at the options prompt, type 
  185.     "A", followed by "1" or "2" to specify the envelope size: 1 for smaller 
  186.     (letter) size envelopes, about 3.625 x 6.5"; 2 for larger (business) size, 
  187.     4.25 x 9.5".
  188.        3.  Optionally, you may include a return address for the upper left 
  189.     corner of the envelope: enter this in "double quotes", using a backslash 
  190.     (\) to mark the beginning of a new line.  Example:
  191.                   Options:  A2"C. Fludd\193 Lakota St\Norman, OK 73069"
  192.     (You may find it convenient to set up envelope printing with your usual 
  193.     return address as a FUNCTION KEY, if you will use it often.)
  194.        4.  Load the envelope correctly in your printer, and press [Enter] to 
  195.     print it.  Then you can continue to edit or print the letter itself.
  196.  
  197.          NOTES: Different printers handle envelope feeding in various ways.  
  198.     With some dot matrix or wheel printers, you can feed in a single envelope, 
  199.     and manual positioning on the platen may be sufficient.  With other 
  200.     printers, a separate tray is available for envelopes, and you will need to 
  201.     install special codes to select the proper tray.  Many laser printers 
  202.     expect to feed envelopes sideways, so you will need codes to print in a 
  203.     landscape font.  [Any control codes needed to prepare your printer for an 
  204.     envelope can be added with VINST; see PRINTER INSTALLATION.]
  205.          Vertical positioning of text on the envelope can easily be changed by 
  206.     adding linefeeds to the initialization string.  Horizontal positioning can 
  207.     be changed with the "L" print option.  Because of the way laser printers 
  208.     operate in landscape mode, VDE prints both envelope sizes with their RIGHT 
  209.     edge in the same place.  This means that on other printers, the LEFT edge 
  210.     of the smaller envelope must be placed 3" (30 columns) in from the left 
  211.     margin.  If this is inconvenient, it can be overridden by specifying the 
  212.     left margin option (e.g. "L0") AFTER the "A1" option.
  213.  
  214. FILES (^KL,^KR,^KJ,^KF) -  ^KL loads new file(s) to edit, REPLACING the 
  215.     current one.  (If the file has been modified, you will be prompted to 
  216.     confirm that you mean to abandon it.  To save the file first, use ^KD 
  217.     instead; to load file(s) in ADDITION to the current one, use AltL 
  218.     instead.)  You can enter any number of filenames, with optional line/page 
  219.     numbers and modes (see SYNTAX).
  220.          ^KR reads in the contents of a single disk file, inserting the text 
  221.     at the current cursor position.
  222.          ^KJ deletes any disk file you specify.  (If you need more complex 
  223.     file utilities, remember that you can run any DOS command with AltR.)
  224.  
  225.          All these commands prompt for specific filenames.  If you are unsure, 
  226.     and want to pick a name from a directory listing, you can call up the 
  227.     "file browser" display by pressing [Enter] alone for *.*, or typing any 
  228.     filename with wildcards, like *.LTR.  (Note: if you mean to load an 
  229.     "untitled" work area, press ^[Enter] (or ^J), instead of [Enter], at the 
  230.     ^KL prompt.  See PROMPTS for other control key usage.)
  231.          Files display alphabetically in uppercase, then directories in 
  232.     lowercase (beginning with the parent directory "..").  If there are more 
  233.     items than will fit on screen, you will see "..." at the top or bottom to 
  234.     indicate this.  Hidden or System files will not display and cannot be 
  235.     edited with VDE.  [Note: VINST can also specify several filetypes (like 
  236.     unreadable .COM or .EXE files) to exclude; they will not display unless 
  237.     specified explicitly, and cannot be edited.]
  238.          You can move the cursor through the list with the arrow keys, 
  239.     [PgUp,Dn], or [Home,End]; additionally, a letter "A-Z" may be typed to go 
  240.     to the next file beginning with that letter, or "\" to go to the next 
  241.     subdirectory.  When the cursor is on a subdirectory, pressing [Enter] 
  242.     allows you to view its contents in turn; when it is on a file, pressing 
  243.     [Enter] selects that file to complete your command.
  244.          If you are loading files, you can also press the "+" key to "tag" 
  245.     files, marking them as a group, and then press [F4] to load them all at 
  246.     once.  Pressing "+" again will untag a file, or [Esc] will untag all.
  247.          You can quit by pressing ^[Break], or clear the display and return to 
  248.     the directory prompt by pressing [Esc] or [Space].
  249.  
  250.          ^KF brings up the full-featured file browser; you may specify a 
  251.     drive, directory, and/or filename mask, and the contents will be 
  252.     alphabetically listed.  (The default, if you just press [Enter], is the 
  253.     directory shown at the ">dir" prompt, and all files *.*.)  Below you will 
  254.     see, in addition to the cursor motions already described, a full 
  255.     complement of operations to apply to the file the cursor is on:
  256.            [F1]   LOAD an additional file to edit;
  257.            [F2]   replace the current file with a NEW one;
  258.            [F3]   READ a file into the current file;
  259.           [Del]   DELETE the file (be careful, deletion is immediate).
  260.     If the file you want to load or read requires a different file mode, you 
  261.     can first press "/" and the correct mode letter (D,N, etc).
  262.          When the cursor is on a directory, you can press [Del] to REMOVE it 
  263.     (if empty), or [Enter] to view its contents.  (This returns you to the 
  264.     ">dir" prompt, where you can actually specify any new drive/directory.)
  265.          You can also press "+" to tag files, marking them as a group, and 
  266.     then press [F4] to load them all at once.  (Other operations cannot be 
  267.     performed while tagging.)  Pressing "+" again will untag a file, or [Esc] 
  268.     will untag all.
  269.          You can quit by pressing ^[Break], or clear the display and return to 
  270.     the directory prompt by pressing [Esc] or [Space].
  271.  
  272. FIND/REPLACE (^QF,^QA; ^L,^\) -  ^QF is the command to FIND a string.  The 
  273.     search normally proceeds from the cursor position forward, and is case 
  274.     (upper-lower) sensitive.  The character ^_ (Ctrl-underline) functions as a 
  275.     wildcard: it will match any single character.  The single code ^M (CR, or 
  276.     [Enter]) indicates a "newline" (CR,LF) in VDE.  Some control codes can be 
  277.     entered directly; some (like ^M) require the ^P prefix.  Graphic 
  278.     characters can be entered using AltG.  Examples:
  279.            Find: ^MLABEL       matches "LABEL" at start of line only;
  280.            Find: p^_^_ce       matches "piece", "peice", etc.
  281.     (Note: because find/replace uses ^M to find CR,LF, it cannot be used to 
  282.     find line overstrikes, CR without LF, created by ^PM.  Use the special 
  283.     code ^^ to find these.)
  284.         ^QA is the REPLACE command.  It asks for a string to find, as above, 
  285.     then what to change it to.  Normally, the cursor will move to each 
  286.     occurrence of the string, and you will be asked ("Chg?") whether to change 
  287.     it; answer "Y"es or "N"o, or "*" to change all the rest without asking 
  288.     individually, or press [Esc] to quit.
  289.          There are several options for find/replace:
  290.            "B" = search Backward for the specified string;
  291.            "I" = Ignore upper/lower case (case insensitive search);
  292.            "W" = whole Word only (skip instances part of a larger word);
  293.            "G" = search Globally (from start or end of file);
  294.            "M" = Multi-file search (through all files being edited);
  295.            "N" = No query: replace all instances without asking.
  296.     To skip the options prompt, finish entry of the find string (for ^QF) or 
  297.     replace string (for ^QA) by typing ^[Enter] (or ^J) instead of [Enter].
  298.          ^L instantly repeats the last find or replace (^QF/^QA) operation 
  299.     once more; the "B,I,W,M,A" options remain as last specified.  ^\ also 
  300.     repeats, but in the reverse direction ("I,W,M,A" remain unchanged).
  301.          NOTES: Replacing will cause reformatting if auto format (^OM) is on.  
  302.     (Be careful with this in a file with varying margins.)  "G"lobal is 
  303.     assumed whenever "M"ulti-file is selected.  "N"o query is assumed whenever 
  304.     ^QA is used in a macro.  [VINST can set "I"gnore-case as your default, in 
  305.     which case specifying "I" means case sensitive.]
  306.  
  307. FOREIGN CHARACTERS -  Characters in the upper ASCII range (128-255), such as 
  308.     foreign letters and accents, can be entered directly into text using 
  309.     either standard DOS method: one of the DOS KEYBxx keyboard map utilities, 
  310.     or the [Alt] key and numeric keypad (hold down [Alt] while pressing keypad 
  311.     1,5,5 for character 155).
  312.          VDE treats these characters as "graphics": you are limited to a total 
  313.     of 32 such codes at a time, and any that you have used may be found in the 
  314.     menu brought up by the AltG command.  See GRAPHICS.
  315.  
  316. GRAPHICS (AltG) -  You can enter a PC graphic (or foreign) character into the 
  317.     file either directly from the keyboard, via [Alt] and the numeric keypad, 
  318.     or with the AltG command.  You will be presented with a menu of up to 32 
  319.     characters (labeled A-Z,1-6) to choose from; the default set contains some 
  320.     useful box drawing parts, and has room free for other characters that 
  321.     might be loaded.  [It can also be modified with VINST.]
  322.          In addition, any individual menu entry can be redefined: type "=", 
  323.     then the code (A-6) to change.  (If a graphic definition is present in any 
  324.     file being edited, you cannot change it.)  You can then select the desired 
  325.     character from the complete graphics set, by moving the cursor to it and 
  326.     pressing [Enter].  Alternatively, if you press [Tab], you may enter the 
  327.     extended ASCII code in either hex (2 digits 80-FF) or decimal (3 digits 
  328.     128-255) format.  Example: the Greek alpha can either be picked off the 
  329.     menu, or entered as "E0" hex or "224" decimal.  Once defined, the graphic 
  330.     can be entered into the file by pressing its menu letter.
  331.          As a further convenience, you can type "-" to clear all entries not 
  332.     needed for graphics already present in your files.
  333.          Graphics are stored in disk files in accord with the current file 
  334.     mode.  Printing of graphics depends on whether your printer font is 
  335.     installed [see PRINTER INSTALLATION] as PC graphics (PC8) or Roman8, or 
  336.     neither, in which case VDE will "emulate" them, choosing standard ASCII 
  337.     character overstrikes that come as close as possible.  This usually works 
  338.     well, especially for the foreign language characters.
  339.          NOTE: a few "control codes" in the ASCII range 00-1F,7F, if entered 
  340.     into a file with ^P, will also appear in the graphics table, because of 
  341.     the way VDE represents them internally.
  342.          CAUTION: If you load a file containing many graphics (or binary data 
  343.     that will be interpreted as graphics), VDE will try to add each in turn to 
  344.     the table.  If the graphics table fills up, any further graphics will be 
  345.     replaced by spaces.  You will see the "Graphics overflow" error message, 
  346.     and protected mode (R/O) will engage, to guard against saving to disk and 
  347.     corrupting the file.  (One common cause of this error is attempting to 
  348.     read a word processor file in the wrong file mode.)
  349.  
  350. HEADER (^OQ) -  The "header" at the top of the screen can be toggled on and 
  351.     off with ^OQ.  [The default can be set either way.]  It provides useful 
  352.     information, but can be removed if you prefer to edit with a screen 
  353.     showing nothing but your text.  It looks like this:
  354.     -----------------------------------------------------------------------
  355.     + VDE.DOC /A      P 14   L 11   C 48    Ins    vt hy AI DS J+ PS " ^K_
  356.                  or (NP)(BZ)             (WIn)(R/O)     (AF)  (MR)
  357.     -----------------------------------------------------------------------
  358.     '+' = Multi-file flag.  Present if other file(s) are being edited.
  359.     'VDE.DOC /A' = Current filename and mode.  The full directory information, 
  360.          along with other files being edited, can be displayed with the ^KI 
  361.          command (see INFORMATION).
  362.     'P 14, etc' = Cursor position in file by page (in document modes), line, 
  363.          column.  If pagination is off (^OP0), you will see 'NP' instead of a 
  364.          page number; in block zoom mode (^KZ) you will see 'BZ'.
  365.     'Ins','WIn' = Insert mode (^V) or Word Insert (^]) on.
  366.     'R/O' = Read/Only, protected mode (^KO) on.
  367.     'vt' = Variable Tab mode (^OV) on. 
  368.     'hy' = Hyphenation (^OH) enabled.  (Documents only)
  369.     'AI' = Auto Indent mode (^OA) on.
  370.     'AF' = Auto Format mode (^OM) on.  (Documents only)
  371.     'DS' = Double spacing (^OS) on.
  372.     'J+/-' = Right Justification mode (^OJ) on.  (Documents only)
  373.     'MR' = Margins released (^OX).  (Documents only)
  374.     'PS' = Proportional spacing (^OK) on.
  375.       "  = Double quote mark appears during macro recording (Esc").
  376.    '^K_' = Command key prefixes (and some prompts) display here.
  377.  
  378.          In 40-column mode, an abbreviated header is shown:
  379.     ----------------------------------------
  380.     + VDE.DOC /A      "I  P 14  L 11  C 48      "I,W" = Insert, Word Insert
  381.                  or (W)(R)     or (^K_)           "R" = Read/Only
  382.     ----------------------------------------
  383.  
  384.  
  385. HYPHENATION (^OH,^P-) -  ^OH toggles hyphenation on and off.  If off, midword 
  386.     hyphens are not treated as wordbreaks.  [The default can be changed.]
  387.          VDE can't hyphenate automatically, but it can recognize hyphens that 
  388.     you type in the text, treating them as a legitimate place to break a line.  
  389.     In addition to ordinary hyphens, "-", there are "soft hyphens" (SHs), 
  390.     which you can enter by typing ^P- (^P,hyphen), and which display in a 
  391.     different color.  SHs indicate optional places to break a long word: they 
  392.     will print as a hyphen when they fall at the end of the line (that is, 
  393.     when actually in use to break a word), but do not print if they wind up in 
  394.     mid-line.  (Note: only WordStar (/W or /S) file modes store soft hyphens 
  395.     as such; when saving to disk in other modes, as in printing, they either 
  396.     become hyphens or disappear, as appropriate.)
  397.  
  398. INFORMATION (^KI,AltI) -  ^KI displays an Information message telling you:
  399.       - The full name (including directory) of the current file;
  400.       - When it was last saved, and whether (Y/N) it has been changed since;
  401.       - Any print toggles (^B,^D,^S etc) that seem to be unpaired;
  402.       - A word count for document files (useful for professional writing);
  403.       - The current size of the file in bytes or K (1K = 1024 bytes);
  404.       - Bytes of memory used in this text segment, and percentage full;
  405.       - The amount (in K) of memory free to edit further files;
  406.       - The names of all other files being edited.
  407.          AltI displays the VDE version, date, and copyright.  (An uninstalled 
  408.     copy of VDE does this automatically on startup.)
  409.  
  410. INSERTING (^V,[Ins],^],^[Ins],^_,^N) -  ^V or [Ins] toggles Insert mode 
  411.     on/off, and ^] or ^[Ins] toggles Word Insert.
  412.          When both are OFF, VDE is in Overwrite mode: when you type a 
  413.     character, it replaces the one the cursor is on; when you press [Enter], 
  414.     the cursor advances to the beginning of the next line of text.  With 
  415.     Insert (^V) ON, when you type a character, it is inserted into the text, 
  416.     while any characters that were already there are carried to the right; 
  417.     when you press [Enter], a return is inserted into the text, causing the 
  418.     beginning of a new line.  [The default insert status, initially ON, can be 
  419.     changed.]
  420.          Word Insert is a hybrid of the two modes: mostly it behaves like 
  421.     Overwrite mode, so you can replace an existing word; but when the cursor 
  422.     reaches the END of the word, it behaves like Insert mode, so you can 
  423.     continue typing without overwriting the next word.  This can be a handy 
  424.     combination for revising existing text.
  425.          The ^_ and ^N commands (insert space, insert CR) are most useful in 
  426.     Overwrite mode (avoiding the need to turn Insert on and back off).
  427.  
  428. JUSTIFICATION (^OJ) -  ^OJ controls right justification mode, cycling between 
  429.     three states:
  430.               ADD.  ("J+" in header.)  Text paragraphs will be 
  431.          formatted with an even right margin, by inserting extra 
  432.          spaces between words as necessary.
  433.               REMOVE.  ("J-" in header.)  Formatting will undo 
  434.          justification by removing any extra spaces between words, 
  435.          leaving an uneven right margin again.
  436.               OFF.  Formatting does not change spacing of text; 
  437.          right margin is left uneven.
  438.     Thus the Reform (^B) command can justify or de-justify text as desired.
  439.          Right-justified text should not be saved to disk in file mode /U 
  440.     (which has no margin structure) or in modes /X,/M,/P, or /F (because 
  441.     XyWrite, MS Word, and WordPerfect will not recognize VDE's method of 
  442.     justification).
  443.          Justification does not work with proportional spacing (^OK).
  444.  
  445. LINE SPACING (^OS) -  ^OS toggles between single and double line spacing.  In 
  446.     double space mode, the following functions generate double carriage 
  447.     returns: [Enter] (^M), Insert CR (^N), Reform (^B), Wordwrap.  You can 
  448.     easily mix single and double spacing; ^B can convert between the two.
  449.          Note: a single-spaced file can also be printed out double-spaced with 
  450.     the "D" option of the ^KP command (see PRINTING).
  451.  
  452. MARGINS (^OR,^OL,^OX,^OC,^OF) -  ^OR sets the Right margin, and enables text 
  453.     formatting.  At the prompt, enter the column number (up to 255), or just 
  454.     press [Enter] for the current cursor column.  (Note: in proportional mode 
  455.     (^OK), the number is interpreted in 1/10" instead of characters.)
  456.          ^OL similarly sets the Left margin column; the value must be less 
  457.     than the right margin.  (^OL is normally used for indenting selected 
  458.     paragraphs.  To leave blank space at the left of the page throughout when 
  459.     PRINTING, see the "L" option of the ^KP command, or the left margin 
  460.     setting in PRINTER INSTALLATION.)
  461.          "Wordwrap" is automatic in all document modes whenever the margins 
  462.     are set: anything typed before the left margin will move up to it; 
  463.     anything typed past the right margin will wrap over to the next line.  
  464.     (See also REFORMAT and AUTO FORMAT.)  Wordwrap and formatting are disabled 
  465.     if the right margin is set to 1, or while margins are released (^OX).
  466.          (NOTES: Margins cannot be set in nondocument modes ; a left margin 
  467.     cannot be set in /X, /U, or /M mode.  On top/bottom margins see PRINTING.)
  468.          ^OX toggles margin release, allowing you to type outside the margins.  
  469.     Use ^OX again to cancel.
  470.          ^OC Centers the current line with respect to the margins; ^OF sets 
  471.     the line Flush right.  Afterward, the cursor advances to the next line.
  472.  
  473. MATCHING FILES (AltM) -  This command can locate small differences between two 
  474.     largely similar files (perhaps an earlier and a later revision of your 
  475.     work).  You must first load these two files (AltL), then split the screen 
  476.     between them (AltW), and position the cursor in corresponding places in 
  477.     both files (for example, the top).
  478.          Then press AltM.  Starting from these positions, VDE searches for any 
  479.     difference between the files.  If there is one, VDE will stop on those 
  480.     lines, showing the disagreeing passages side by side.  If you want to 
  481.     continue, press AltM again.  (If the difference was significant you may 
  482.     first need to reposition one cursor to match the other.)  If the cursor 
  483.     winds up at the end of both files, they match.
  484.          Note: in document modes, AltM compares word by word, ignoring mere 
  485.     formatting differences (margins, spacing etc).  In /N mode, it is an exact 
  486.     character by character comparison.
  487.  
  488. MENUBARS (^[Esc]) -  This command is used to call up the MenuBar.  Press the 
  489.     hilighted letter to select a submenu, then select again to perform a 
  490.     command.  You can press [Esc] or [Space] to back up to the main menu, or 
  491.     ^[Break] to abort.
  492.          The ^[Esc] command can also be used in a macro definition; if entered 
  493.     at the Esc[ prompt, it displays as a hilighted "!", and should be followed 
  494.     by one or two letters for menu selections.  (This feature is used in the 
  495.     WordPerfect compatibility macros contained in WP.VDF, to present menu 
  496.     choices; see DEFAULT FUNCTION KEYS.)
  497.  
  498. MULTIPLE FILES (AltL,AltB,AltN,AltX,AltQ,AltC,AltP) -  VDE allows you to edit 
  499.     up to 8 files simultaneously, if you have enough memory.  This can be done 
  500.     from the command line, by giving a list of several filenames.
  501.          Otherwise, to Load additional files, press AltL.  You can enter any 
  502.     number of filenames, with optional line/page numbers and modes (see 
  503.     SYNTAX); for an "untitled" work area, press ^[Enter] (or ^J).  You can 
  504.     also access the file browser with [Enter] or wildcards (see FILES).  (You 
  505.     will get an error message if you run out of memory, or are already editing 
  506.     the named file, or 8 files.)
  507.          Once multiple files are in use, AltB and AltN can be used to cycle 
  508.     back and forth through the files being edited.  If you Quit or Exit 
  509.     (^KQ,^KX) from one file, you will be returned to the previous one.
  510.          For convenience, AltX exits ALL files immediately, saving any changes 
  511.     made.  AltQ quits ALL files immediately, without saving; if any of them 
  512.     have been modified, you will be prompted (just once) to confirm this.
  513.          AltC Cuts a marked block of text, placing it in a buffer for later 
  514.     recovery.  [VINST lets you choose whether the block will also be deleted.]  
  515.     AltP Pastes in the previously cut text at the cursor position, allowing 
  516.     block copying and moving between files.
  517.          It is possible to view two files on screen at once (see WINDOWS).
  518.  
  519. PAGINATION (^OP,^PL) -  The ^OP command sets the page length.  Enter a value 0 
  520.     to 255 lines, or just press [Enter] to restore the default.
  521.          When the value is nonzero, it determines the page and line shown in 
  522.     the document header ("P xx L xx"), and all page functions in the Print 
  523.     routine (pagination, headers, start/stop at page) are enabled.  A formfeed 
  524.     will be sent to eject each full page.  [VDE does not send a formfeed 
  525.     before printing; install one in your printer initialization if you want.]
  526.          When the value is zero, pagination is off.  The header will say "NP L 
  527.     xxxx", showing you the absolute line number in the file; printing occurs 
  528.     with no page breaks, though a formfeed is sent at the end of the file.  
  529.     (To skip even this, use the block print option "B", which allows you to 
  530.     print several small things on the same sheet or, in conjunction with the 
  531.     "*" option, multiple copies of index cards, labels, etc.  See PRINTING.)
  532.          The ^PL command embeds a formfeed (^L) in the text, to begin a new 
  533.     page; the best place to put it is at the beginning of a line.
  534.  
  535. PARAGRAPH INDENT (^OG) -  Of course you can indent text simply by changing the 
  536.     left margin (^OL), but there are times when you want only a temporary 
  537.     indent.  ^OG gives a "paragraph indent"; each time you use it, the left 
  538.     margin is reset to the next tab stop over (see TABS).  The indentation 
  539.     lasts until you type the [Enter] at the end of the paragraph (or use the 
  540.     ^B or ^OL commands), at which time the original left margin is restored.
  541.  
  542. PLACE MARKERS (^KM,^QM) -  You can set any number of temporary place markers 
  543.     in the text with ^KM, when you want to return to a spot later.  The marker 
  544.     displays as a highlighted "!", and can be deleted if no longer needed.  
  545.     The ^QM command moves the cursor to the next place marker in the file, 
  546.     cycling back to the top of the file as needed.  Place markers are NOT 
  547.     saved to disk.
  548.  
  549. PRINT PREVIEW (^OD) -  This command shows you a preview of the text as it 
  550.     would print: with all non-printing codes (markers, ^P codes, etc) hidden, 
  551.     and page breaks indicated by a row of dotted lines.  This is handy for 
  552.     making sure that text is aligned properly, and will help you avoid wasting 
  553.     time and paper on unacceptable printouts.  You can scroll through the file 
  554.     in this mode with [PgUp,Dn] or ^R,^C; or move to the top or bottom, with 
  555.     ^[Home,End].  Press [Esc] to continue editing.
  556.  
  557. PRINT STYLES/CODES (^P) -  This command prefix is used to enter various 
  558.     "codes" in the ASCII range 00-1F into the text, usually for purposes of 
  559.     printer control.  Most codes are entered in a standard fashion: ^PA embeds 
  560.     ^A, etc.  Those with defined functions in VDE documents display as 
  561.     highlighted letters, and always insert; the rest (all, in nondocuments or 
  562.     /A mode) display as graphics, and observe the current INSERT status.  
  563.     (Warning: use ^PZ with caution, since many programs treat ^Z (hex 1A) as 
  564.     an end of file mark.)
  565.          Several other common control codes produce special effects:
  566.           ^P^I - hard (ASCII) tab - printers respond variously to this
  567.             ^L - formfeed - will cause a page break
  568.             ^H - backspace - overstrike previous character
  569.             ^M - carriage return - enter a CR without a LF to overstrike line
  570.                   (do NOT hit [Enter] again after this, just continue typing)
  571.     The further codes below do NOT operate in nondocuments or /A mode.
  572.          ^P^G causes printing to pause immediately, until you press a key to 
  573.     continue ([Esc] will cancel).  This allows you to adjust the platen for 
  574.     printing various forms.  (Note: on many dot matrix printers, can only be 
  575.     used at the start of a line.)
  576.          ^P,Esc or ^P[ can be used to embed the "Escape" code (hex 1B) in a 
  577.     file if desired.  But these are most commonly used for printer control, 
  578.     and VDE offers a much simpler way of doing this.  In place of complex 
  579.     "escape sequences" for print styles (underlining, etc) in document files 
  580.     VDE lets you enter a single marker, which will be translated into the 
  581.     proper codes during printing.  VDE supports a set of 13 codes for this 
  582.     purpose: seven toggles, six switches.  [See PRINTER INSTALLATION on how to 
  583.     install the proper driver for your printer.  Otherwise, only ^PS and ^PX 
  584.     will work.]  The conventional WordStar meanings of these codes are:
  585.        Toggles: ^P^B  boldface        Switches: ^P^Q  (user def 1)
  586.                   ^D  ("doublestrike")            ^W  (user 2)
  587.                   ^S  underline                   ^E  (user 3)
  588.                   ^Y  italic ("ribbon")           ^R  (user 4)
  589.                   ^T  superscript                 ^A  alternate pitch
  590.                   ^V  subscript                   ^N  standard pitch
  591.                   ^X  strikeout [with "-", "/", etc -- see USER OPTIONS]
  592.     But you can use them for anything you like.  "Toggles" are good for 
  593.     features like underlining that are turned on and off; enter them in pairs, 
  594.     to mark the beginning and end of the desired text.  "Switches" are better 
  595.     for multi-valued parameters like character pitch or print quality.
  596.          If toggles are not properly paired, you will find print effects 
  597.     continuing throughout the rest of your document.  To save time and effort, 
  598.     use the ^KI command to check for this before printing.  (If an "S" appears 
  599.     under the "^ Check" heading, there is an unpaired ^S somewhere.)
  600.  
  601. PRINTER DRIVERS (AltV,AltU) -  Since many people use more than one kind of 
  602.     printer, VDE accomodates two different printer drivers, a primary and an 
  603.     alternate.  Before printing a file, you can select which one is active 
  604.     using AltV.  [You can install different drivers with VINST.]
  605.          AltU gives you access to an unlimited number of further printer 
  606.     drivers in the form of .VDP disk files; select "L"oad, then type the file 
  607.     name.  [See PRINTER INSTALLATION for instructions on how to create such 
  608.     files.]  The new driver will replace the previous primary.
  609.  
  610. PRINTING (^KP) -  The ^KP command Prints the file you are editing.  The page 
  611.     format is determined by several factors: the current page length (^OP) 
  612.     determines the number of lines of text per page.  The top and left margins 
  613.     can be varied with options below.  Other options produce either a centered 
  614.     page number at the bottom of the page, or a header, consisting of a page 
  615.     number in the corner and/or a string of text; the spacing of these is 
  616.     controlled by settings in the printer driver.  Various printers position 
  617.     paper differently, but can typically put at least 60 lines of text on a 
  618.     standard 11-inch page.
  619.          You will be asked for a set of "Options:", at which point you may 
  620.     enter one or more of the following, in any order:
  621.  
  622.        @nn    begins printing AT page nn of the document.
  623.        =nn    RENUMBERS the printout so first page is numbered nn.
  624.        #nn    prints only (up to) a TOTAL of nn pages.
  625.        O,E    prints only Odd or Even pages (print one, then run the paper 
  626.             back through and print the other, for double-sided printing).
  627.        F      prints FACING pages (header/number reversed on even pages).
  628.        *nn    prints the entire job out nn TIMES (nn=1...255).
  629.  
  630.        N      NUMBERS pages sequentially, at top right.
  631.        C      numbers pages at bottom CENTER.
  632.      "..."    uses the quoted string as a HEADER.  The string will print at 
  633.             the top right next to the page number unless it begins with a "<" 
  634.             character, in which case it prints at the left edge.
  635.               Note: you can include the current Filename, Time or Date in the 
  636.             header simply by entering ^F, ^T, or ^D, respectively.  To enter a 
  637.             quote mark, double it ("").
  638.        S      SUPPRESSES the header/page number on the first page of output.
  639.        Tnn    sets a TOP MARGIN skip of nn lines.     [The default margins can
  640.        Lnn    sets a LEFT MARGIN skip of nn columns.    be set with VINST.]
  641.  
  642.        B      prints only the currently marked BLOCK.  Pagination is disabled, 
  643.             and no final formfeed is sent; you may have to eject the page.
  644.   (FILENAME)  redirects printer output to a disk file.  All print control 
  645.             codes will go into the file just as they would have been sent to 
  646.             your printer.  If you want to append the output to an existing 
  647.             file, type a "+" before the name: (+FILENAME).
  648.        A      ADDRESSES an envelope; see ENVELOPES.
  649.        P      PAUSES for your keystroke before each page prints (sheet feed).
  650.        ^      FILTERS control codes (like ^X) so they print out as text "^X".
  651.        D      DOUBLESPACES the printout.
  652.      '...'    sends an additional string of printer initialization commands 
  653.             before printing begins.
  654.  
  655.               EXAMPLE 1:      Options:  "<STATUS REPORT: ^D" N F
  656.     will put a header like "STATUS REPORT: 10/19/90" at the top left of each 
  657.     page, and the page number at the top right (vice versa on even pages).
  658.               EXAMPLE 2:      Options:  L12 #1
  659.     will print one page only, with an added left margin of 12.  (Printing a 
  660.     single page is a good check of page layout before going ahead to print a 
  661.     long file.  To continue at page two, of course, use Options:  @2.)
  662.               EXAMPLE 3:      Options:  BD(+SCRATCH)
  663.     will append the print output of the current marked Block, double spaced, 
  664.     to the disk file SCRATCH.
  665.  
  666.          ABOUT PAGINATION:  If you set the page length to 0 (see ^OP) or 
  667.     select the 'B' option to print only a block, the output will NOT be 
  668.     paginated by VDE -- that is, data will be sent to the printer in a 
  669.     continuous stream, and the printer will break pages when it considers them 
  670.     full.  No headers or page numbers will be printed; in fact, none of the 
  671.     options @,=,#,O,E,F,N,C,S,T,P,"...", which involve page numbering, are 
  672.     allowed with 'B'.  If for some reason you do want paginated printing of a 
  673.     block only, you must cut and paste it to a new file (see AltC,P), and 
  674.     print it as a separate file.
  675.  
  676.          ABOUT MARGINS: A left margin that is part of a document's format (via 
  677.     ^OL, etc) affects the file text but not placement of headers or page 
  678.     numbers.  Left margin settings external to the text ("Lnn", or printer 
  679.     driver default) shift the entire printout to the right, including headers 
  680.     and page numbers.  Because these settings are also in columns, their 
  681.     physical width will vary according to the font in use; you will get more 
  682.     consistent results if you use your printer's absolute left margin setting 
  683.     feature (see PRINTER INSTALLATION).
  684.  
  685.          ABOUT INITIALIZATION:  Codes '...' must be entered as actual 
  686.     characters or control codes, not digits.  If the command is "Esc A" (1B 41 
  687.     hex), press quote, ^P, [Esc], A, quote.  To enter a quote mark (27 hex), 
  688.     double it ('').  (Some control codes, including Esc, must be entered with 
  689.     the ^P prefix; see PROMPTS.  Codes 00-1F are entered as ^A, ^B, etc.  For 
  690.     an ASCII table see PRINTER INSTALLATION.)  An empty string ('') can be 
  691.     used to skip the driver's usual initialization, and can be followed (after 
  692.     a space) by another string '...' to use instead.
  693.  
  694.          OTHER NOTES:  Options 'C' and 'N' cannot be used together.
  695.          If you are in /W or /S file mode, any WordStar dot commands in the 
  696.     file (lines beginning with ".") will not be printed.
  697.          You can cancel printing at any time by pressing [Esc], or pause by 
  698.     pressing any other key (press a key again to resume).
  699.  
  700. PROPORTIONAL SPACING (^OK) -  Normally VDE assumes a fixed pitch font: one 
  701.     character equals one print column.  Yet if your printer has a proportional 
  702.     font, you can get VDE to use it, and to format text so that it will print 
  703.     with more appropriate margins.  Use ^OK to toggle proportional mode on and 
  704.     off.  When on, you will see "PS" in the header; all wordwrap and 
  705.     reformatting (^B,^OC,^OF) will take advantage of a table of varying 
  706.     character widths, for a better aligned printout, though line lengths may 
  707.     look uneven on screen; and when you print, a proportional font will be 
  708.     selected.
  709.          In proportional mode, the right margin needs to be interpreted in 
  710.     inches rather than characters, based on a conversion of 10 cpi, so that a 
  711.     right margin (^OR) of 70 means 7.0".  (Note: characters may extend well 
  712.     beyond the 70th column.)
  713.          Mixing proportional and fixed print in the same document is a little 
  714.     tricky.  You must install and use a print (^P) toggle or switch to 
  715.     alternate between the two fonts, type or format the fixed pitch parts with 
  716.     ^OK off, the proportional parts with ^OK on (and appropriately altered 
  717.     margins), and then print with ^OK off.
  718.          [See PRINTER INSTALLATION to install codes for proportional mode on 
  719.     your printer, and CHARACTER WIDTHS to adjust the width table.]
  720.  
  721. PROTECTED MODE (^KO) -  When you want to view a file without accidentally 
  722.     modifying it, you can engage protected mode with ^KO: the flag "R/O" (for 
  723.     Read/Only) shows in the header, and any command that would modify the file 
  724.     will be rejected as an "Invalid Key".  To disengage, use ^KO again.
  725.          If you load a file with the DOS R/O attribute, protected mode will 
  726.     engage automatically, and the ^KO command will not be able to disengage 
  727.     it.  The text cannot be modified with VDE, unless you first rename it 
  728.     (^KE) to a new filename.
  729.  
  730. REFORMAT ([Enter],^B;^OB) -  In documents, pressing [Enter] creates a 
  731.     permanent or "hard" Carriage Return marking the end of a paragraph.  (This 
  732.     is a CR without a preceding space; wordwrap creates a removable "soft CR", 
  733.     preceded by a space.  See TEXT FORMATTING.)
  734.            ^B reformats the paragraph the cursor is in according to the 
  735.     current margin settings and line spacing.  (Thus ^B is used not only to 
  736.     reshape a paragraph after editing, but also to change its format in 
  737.     various ways: see MARGINS, JUSTIFICATION, LINE SPACING.)  If the top line 
  738.     is indented relative to the next one, VDE preserves that as paragraph 
  739.     indentation.  To reformat an entire file use the MACRO command (Esc[) to 
  740.     repeat ^B.  (See also AUTO FORMAT.)
  741.          ^OB toggles display of hard CRs, which are normally marked by a left- 
  742.     arrow character in document files, to distinguish them from soft ones.  If 
  743.     you find this distracting, it can be turned off.
  744.  
  745. RULER LINE (^OT) -  To help you align text properly, ^OT displays a "ruler 
  746.     line" above the text.  Type ^OT again to remove it.  A moving pointer 
  747.     indicates the current column.
  748.          In each column you will see one of several symbols: the arrow "v" is 
  749.     the cursor column; "L,R" designate the current margins; "." indicates 
  750.     areas outside the current margins, "-" within them.  Also, tab stops are 
  751.     marked by either "!" (Variable) or ":" (Hard).  Examples:
  752.         (/D mode)      L-----!---!----------v--!--------------R........
  753.         (/N mode)      :.......:.......:....v..:.......:.......:.......
  754.  
  755. RUN COMMAND/SHELL (AltR) -  AltR lets you run DOS commands without leaving 
  756.     VDE.  An imitation DOS prompt is produced (e.g., "C:\WORK>"); you can copy 
  757.     or rename files, or run any other program you like, and afterwards VDE 
  758.     will prompt you to "Press [Esc]", which will return you to your undis- 
  759.     turbed VDE editing session.
  760.          In addition, you may simply hit [Enter], which lets you out into what 
  761.     is known as a Command Shell: you are actually back IN DOS, and can use any 
  762.     number of commands or move around as you like; when through, you need to 
  763.     type the DOS command EXIT to return to VDE.
  764.          Caution: don't load new memory-resident utilities from within the 
  765.     AltR command; this fouls up the DOS memory allocation.
  766.          To use AltR, you must have enough free memory to load and run the 
  767.     chosen program; and VDE must be able to find COMMAND.COM in order to 
  768.     execute it, via the COMSPEC environment variable.  Be sure either that 
  769.     your AUTOEXEC.BAT file includes a line like
  770.                         SET COMSPEC=C:\COMMAND.COM
  771.     or that your CONFIG.SYS file includes a line like
  772.                         SHELL=C:\COMMAND.COM C:\ /P
  773.     (In either case replace "C:\" with the appropriate directory.)
  774.  
  775. SAVE/EXIT (^KE,^KS,^KX,^KD,^KQ) -  ^KE renames your work, allowing you to 
  776.     change the filename (including directory) to which it will be saved, 
  777.     and/or the filemode governing its format.  At the prompt you can enter a 
  778.     new filename, a new directory, a new mode, or any combination of these.  
  779.     You can make your work "untitled" by pressing ^[Enter] (or ^J) at the 
  780.     prompt.  (See PROMPTS for other control key usage.)
  781.          ^KS saves your work so far, writing the file to disk under the 
  782.     filename in the header.  (If it's "untitled", a new name will be 
  783.     requested.)  If the file has not been modified, you will be prompted to 
  784.     confirm that you meant to save it again anyway.  For safety, when you save 
  785.     changes to an existing file, a copy of the previous version is preserved 
  786.     as a BACKUP FILE (with the same name, but extension ".BAK").  If you 
  787.     decide to abandon your latest changes, you can recover the old version 
  788.     from the BAK file.  [You can choose not to maintain BAK files, if you 
  789.     prefer; see VINST, OPTIONS.]
  790.          There are several different commands for finishing up:
  791.        ^KX saves your work (if modified), and then exits VDE.
  792.        ^KD saves your work, then loads a new file to edit.
  793.        ^KQ just QUITS, without saving to disk.  If the file has been modified, 
  794.     you will be prompted to confirm that you meant to do this!
  795.  
  796. SCREEN CONTROLS (^W,^Z; Esc[^,v,<,>]; ^OE,^OZ) -  VDE provides a number of 
  797.     commands to control the display screen:
  798.          ^W and ^Z scroll the screen up and down a line at a time, without 
  799.     moving the cursor in the text (unless necessary).
  800.          Preceded by [Esc], any arrow key also causes the screen to scroll: 
  801.     up/down by 1/4 screen, or right/left 32 columns.  Again, the cursor is not 
  802.     moved unless necessary.  (The screen cannot shift rightward past the end 
  803.     of the current line.)
  804.          ^OE makes the current line the top of the screen.
  805.          ^OZ temporarily blanks the entire screen; good for avoiding CRT burn- 
  806.     in, or just protecting work from prying eyes or fingers.  Restore the 
  807.     screen by pressing [Esc].  This is also useful if some other software 
  808.     (like a memory-resident utility) has messed up the screen: type ^OZ,Esc 
  809.     and VDE will completely restore it.
  810.  
  811. SCREEN SIZE (AltA,AltE) -  VDE automatically adapts to any size text screen 
  812.     currently in use (minimum: 40 columns, 8 lines).  This means that VDE 
  813.     supports nonstandard screen sizes (like 96 or 132 columns) provided by 
  814.     some PC video systems; it will run on laptop/palmtop computers with 
  815.     smaller displays; and visually impaired users can use the DOS command MODE 
  816.     40 to edit with a 40 column large-type screen.  When running with fewer 
  817.     than 80 columns, VDE omits most toggle indicators from the header, and 
  818.     truncates the function key labels; also, some menus remain in 80-column 
  819.     format, and can be scrolled horizontally by pressing the [<,>] keys while 
  820.     they are on screen.
  821.          You can use your own software (like the popular UltraVision program, 
  822.     or any utilities that may have come with your video adapter card) to 
  823.     change the font or screen size (lines,columns) before running VDE, or even 
  824.     while editing (via the AltR command).  VDE also offers two internal 
  825.     commands to vary screen size:
  826.          AltA changes the screen width, toggling between normal (80-column) 
  827.     mode and wide (132-column) mode.  It can be used alone, or in combination 
  828.     with AltE.  This command works ONLY with certain brands of video cards 
  829.     which offer 132 column displays [see INSTALLATION to specify yours], or if 
  830.     you are running UltraVision with a card that supports its 132 column mode.
  831.          AltE changes the screen length (font size), varying the number of 
  832.     text lines displayed.  In its most basic form it simply toggles between 
  833.     normal 25-line mode and a compressed mode of 43 (EGA) or 50 (VGA) lines.  
  834.     But when possible (with VDEOPT.DAT present or under UltraVision), it 
  835.     displays a prompt offering a wider range of sizes:
  836.               with VDEOPT.DAT  VGA - 20,25,28,33,40,50,57 lines
  837.                                EGA - 17,25,29,35,43,50    lines
  838.               with UltraVision VGA - 25,36,50,60/63 lines
  839.                                EGA - 25,34,43,60    lines
  840.     You can enter a letter code A-G, or [Enter] for your default value [which 
  841.     can be changed with VINST].  Larger text is easy on the eyes; smaller text 
  842.     can pack a whole page of text into one screen.  To make this range of 
  843.     sizes available (without UltraVision), the VDEOPT.DAT file must be in the 
  844.     current or VDE directory (see DIRECTORIES).
  845.          NOTE: Under DESQview, you must use its "Rearrange:Video" menu 
  846.     selection to change text sizes; VDE's own commands will not work.
  847.  
  848. SPELLING CHECK (AltH,AltJ) - If you have the optional spelling checker, AltH 
  849.     will check spelling of the word at the cursor, and AltJ will go through 
  850.     the document beginning at the word after the cursor.  See the VDESPELL.DOC 
  851.     file that comes with the speller for complete instructions.
  852.  
  853. SPLITTING FILES (AltS) -  If you encounter a text file that is too large for 
  854.     VDE to load and edit, you can divide it into manageable chunks with the 
  855.     Split command.  You will be prompted for the name of the file to split; 
  856.     VDE will divide it in pieces whose names have a number added at the end of 
  857.     the file name.  Example: BIG.DOC will split into BIG1.DOC, BIG2.DOC, etc, 
  858.     each of which you can edit separately.  After 9, the numbers continue with 
  859.     letters A..Z.  (The original file also remains on disk.)
  860.          If necessary, the files can later be reassembled into one with the 
  861.     DOS COPY command, for example:  COPY BIG1.DOC+BIG2.DOC BIG.DOC.
  862.  
  863. TABS ([Tab],Shft[Tab]; ^OV,^OI,^ON; ^PI,Esc[Tab]) -  There are two tab modes, 
  864.     Variable and Hard; ^OV toggles between them.
  865.          In Hard Tab mode (the default for nondocuments), the [Tab] key 
  866.     produces an actual ^I (ASCII TAB) character, which will overwrite the 
  867.     character at the cursor or, if Insert is on, insert before it.  Hard Tabs 
  868.     produce indents at fixed intervals [normally 8 columns; optionally 4 or 
  869.     16], and also display as a highlighted "I" in document modes.
  870.          In Variable Tab mode (the default for documents), the [Tab] key moves 
  871.     to the next tab stop set.  In Overwrite mode, the cursor moves over any 
  872.     existing text; in Insert mode, spaces are inserted into the text.  In 
  873.     either case, spaces are added at the end of a line if needed.
  874.          Up to eight tab stops may be set with ^OI, or cleared with ^ON; the 
  875.     defaults are in columns 6, 15, 35, and 55.  [These can be changed.]  Both 
  876.     commands prompt for a list of column numbers, or you can press [Enter] for 
  877.     the cursor column.  The Set command ^OI also accepts two options, both of 
  878.     which replace all previous tab settings:
  879.               @nn           Set tabs every "nn" columns
  880.               #n1,n2,...    Set tabs to columns "n1,n2,..." ONLY
  881.     You can simply clear all variable tabs by typing ^ON followed by "*".
  882.          The Shft[Tab] command tabs backwards (left to the previous stop), 
  883.     useful for moving around in tables, etc.
  884.          You can always get a Hard Tab with ^PI, or a Variable Tab with 
  885.     Esc[Tab], no matter which tab mode you are in.
  886.  
  887. TIME/DATE (AltT,AltD) -  VDE can read the DOS system clock and insert the 
  888.     current time and date in your file automatically.  Just press AltT for the 
  889.     Time, or AltD for the Date.  The string will appear at the current cursor 
  890.     location, as though you had typed it in yourself: for example,
  891.               1:21 PM            [or 13:21 -- VINST selects the format]
  892.               January 15, 1988   [or 1/15/88, 15 January 1988, 15.1.88]
  893.  
  894. UNDELETING (^U) -  The undelete function can be used to recover accidentally 
  895.     deleted text or overstruck characters.  The lost text will be replaced at 
  896.     the current cursor location.  ^U may be used repeatedly to undo a sequence 
  897.     of deletions, recovering each character, word, or line in order.  (Once 
  898.     all deleted text is restored, ^U does nothing.)
  899.          Exception: block deletions cannot be recovered sequentially, they 
  900.     must be undeleted immediately (before any other deletion occurs).
  901.          Undeletion can also be used as a sort of quick-and-dirty block move.  
  902.     For example, if the cursor is at the start of a word, the commands ^T^F^U 
  903.     (which of course can be assigned to a function key) will swap that word 
  904.     with the one following it.  Similarly, ^Y^X^U will swap two lines.
  905.  
  906. UPPER/LOWER CASE (^^; ^K",^K',^K^) -  ^^ (Ctrl-caret or 6) reverses the case 
  907.     of the character at the cursor, if it was a letter, and moves to the next.
  908.          The ^K^ (^K-caret) command reverses all text in a marked block (see 
  909.     BLOCK COMMANDS); ^K" makes all text in the block uppercase, ^K' lowercase.
  910.  
  911. WINDOWS (^OW; AltW,AltF; ^[PgUp,PgDn]) -  VDE can split the screen into two 
  912.     windows, showing either two parts of the same file or two different files.  
  913.     In either case, AltF moves the cursor back and forth between the two 
  914.     windows.  ^[PgUp] and ^[PgDn] scroll BOTH windows in synchronization.
  915.         ^OW is used within a SINGLE file; it creates a second window 
  916.     (originally a duplicate of the first, of course) in which you can move to 
  917.     and view or edit another location in the file at the same time.  (Note: 
  918.     any modifications made to the file will not be reflected in the inactive 
  919.     window until you return to it.)  Type ^OW again to undo windowing.
  920.         AltW splits the screen Window between two DIFFERENT files being 
  921.     edited, showing you both at once (note the different filename in the 
  922.     second window).  Type AltW again to undo.
  923.         If you call up a command menu (like ^J or ^KP) that will not fit in 
  924.     one window on a small screen, windowing will be turned off to display it.
  925.  
  926.  
  927. ================================  7. MACROS  =================================
  928.  
  929.  
  930. AUTOEXEC MACRO -  VINST can designate any function key definition you create 
  931.     as "autoexec", meaning a macro that will execute automatically whenever 
  932.     you first enter VDE.  This feature can be used for a variety of purposes, 
  933.     including changing defaults not available through VINST options.  See also 
  934.     FUNCTION KEYS.
  935.          Notes: if you load multiple files, remember that for settings which 
  936.     are specific to each file (like margins), only the first file will be 
  937.     affected.  You cannot use a utility like KEYSTACK that stuffs input into 
  938.     the DOS keyboard buffer before running VDE, if an autoexec macro exists.
  939.  
  940. FUNCTION KEYS ([F1]...[F12]) -  Up to 48 macros can be assigned to function 
  941.     keys; they can then be recalled and used with one keystroke.  Each PC 
  942.     function key can be used alone or with Shift, Ctrl, or Alt, to produce:
  943.                     [F1]...[F10]  =  F1....F10 in VDE notation
  944.               Shift-[F1]...[F10]  =  !F1..!F10
  945.                Ctrl-[F1]...[F10]  =  ^F1..^F10
  946.                 Alt-[F1]...[F10]  =  @F1..@F10
  947.     And, if you have an Enhanced (101-key) AT keyboard, also:
  948.               F11, F12, !F11, !F12, ^F11, ^F12, @F11, @F12
  949.     VDE comes with [F1] set as a "Help" key (^J), but this can be changed.
  950.  
  951.          The Esc[ and Esc] commands (see MACRO DEFINITION) give the option of 
  952.     Storing the macro definition to any function key, so that the macro can 
  953.     later be executed simply by pressing that key.  If you choose "Store",
  954.             VDE asks "Make Quiet, No-repeat, Both?"  Reply "Q" for a 
  955.          key that executes in Quiet (fast) mode; "N" for a key that 
  956.          runs once, without asking for a repeat count; or "B" for 
  957.          both of these.  Press [Enter] instead for a key that 
  958.          executes just like the "Use macro" option, visibly, asking 
  959.          for a repeat count first.
  960.             VDE asks "Store to key?"  Press the desired function 
  961.          key, from [F1] to [@F12].
  962.             VDE asks "Label?"  Enter a label, up to 7 characters, to 
  963.          identify this definition on the key label line (see 
  964.          FUNCTION KEY LABELS).
  965.     Again, don't choose "Q"uiet for a key that will request input from you.
  966.          There is a total of about 974 bytes available for all 48 keys, and a 
  967.     127 byte limit (due to the VDE input line) for any one key.  Trying to use 
  968.     an undefined key results in an error.  You can delete a key definition by 
  969.     entering an empty macro string (Esc[, [Enter]) and storing it to the key.
  970.          Keys defined with Esc[ or ] last only during the current editing 
  971.     session (VDE.COM itself is not modified).  [VINST lets you install 
  972.     definitions permanently; see DEFAULT FUNCTION KEYS.]
  973.  
  974.          EXAMPLES: Keys are useful for storing a frequently repeated phrase; 
  975.     [F3] is much more convenient than "World Wide Widgets Ltd. (N.A.)".  You 
  976.     might also use several for sets of margins, like: ^OL 5 [Enter] ^OR 60 
  977.     [Enter].  A key defined as ^QR ^N AltD ^OF would place the current date at 
  978.     the top right of a letter.  Many VDE users set up a function key to 
  979.     produce a personalized letterhead: for example, the macro
  980.               ^N John Doe ^OC ^N 123 Main St ^OC ^N City, State ^OC
  981.     will insert that three-line address, neatly centered.  You can add print 
  982.     effects (bold, italic) to suit your taste.  For a solid line separating 
  983.     this from the body of the letter, try adding
  984.                           ^N ^PS ^OF ^E ^V ^PS ^V ^X
  985.          Function keys can be used to create powerful new commands, for 
  986.     example: ^D ^A ^KB ^F ^KK will mark the current word as a block.  And, 
  987.     similarly, ^QS ^KB ^X ^KK will mark the current line as a block.
  988.  
  989. FUNCTION KEY LABELS (^OU) - To help you remember the purpose of your function 
  990.     key definitions, the ^OU command toggles the display of a label line at 
  991.     the bottom of the screen.  When a key is defined, its number will appear 
  992.     on the label line, followed by the label (if any) entered when the key was 
  993.     stored.
  994.          The label line is sensitive to keyboard shift status; if you press 
  995.     and hold Shift, Ctrl, or Alt for a moment, the labels will change to show 
  996.     those for the shifted function keys.
  997.          On 80-column screens, 10 labels are visible; in 40-column mode, 5.  
  998.     Labels for the F11, F12 keys only appear on screens of 96 or more columns.
  999.  
  1000. KEY DEFINITION FILES (AltU) -  These files save function key definitions and 
  1001.     labels, and should be given a file type of ".VDF".  You can load such a 
  1002.     file, along with your text file(s) to edit, from the command line (see 
  1003.     SYNTAX).
  1004.          AltU can be used while editing: it will ask whether you want to 
  1005.     "L"oad or "S"ave such a file, then prompt for the name of the file.  If 
  1006.     you load such a file, those definitions will replace any previous ones.  
  1007.     If you save, the current definitions will be written to the file.  [Key 
  1008.     definition files can also be created or installed as defaults in your copy 
  1009.     of VDE, using VINST.]
  1010.  
  1011. MACRO DEFINITION AND USE (Esc[,Esc]) -  To DEFINE a macro, type Esc[.  You 
  1012.     will be asked for the macro definition; you may want to plan it out first 
  1013.     with pen and paper.  Many special PC keys are not accepted at VDE input 
  1014.     prompts, including here; you must use the WordStar equivalent, like ^R 
  1015.     instead of [PgUp].  Those keys can, however, be recorded (see RECORDING 
  1016.     MACROS), and can be entered when defining a macro with VINST (see DEFAULT 
  1017.     FUNCTION KEYS).  Even MenuBar commands can be used in macros, with the 
  1018.     ^[Esc] command (see MENUBARS).
  1019.          Then you will be asked whether you want to Use the definition you 
  1020.     entered now, or Store it (on storing, see FUNCTION KEYS).
  1021.          Then you need to decide whether you want the macro to repeat (and if 
  1022.     so how many times), and whether you want to watch it happen or not.
  1023.             VDE asks "Make Quiet, No-repeat, Both?"  Reply "Q" for 
  1024.          Quiet (fast) operation, or press [Enter] for visible (slower) 
  1025.          execution.  (The "N" option is intended for storing keys, 
  1026.          but can also be typed here to skip the next question.)
  1027.             VDE asks "Repeat count?"  Type the number of times to 
  1028.          execute (0-254), or just [Enter] for 1; or "*" to repeat 
  1029.          indefinitely.
  1030.         Normally, you can see the results as the macro executes, and you can 
  1031.     cancel it at any time by pressing [Esc].  If you choose to speed up macro 
  1032.     execution by specifying "Q"uiet mode, only the header will be updated as 
  1033.     the macro runs.  (Don't do this if the macro concludes by requesting user 
  1034.     input -- the necessary prompt would not display!)
  1035.          Macros will stop automatically if an error condition occurs, in which 
  1036.     case the error message will display briefly; or if the cursor attempts to 
  1037.     move past the top or end of the file, in which case no error displays.  
  1038.     (Exception: Esc$ can change error handling.  See MACRO PROGRAMMING.)  
  1039.     Thus some macros will halt on their own when they reach the end of a file; 
  1040.     others will have to be terminated manually, by pressing [Esc].
  1041.          Once defined, a macro can be re-used with the Esc] command, which 
  1042.     again gives you the options to (re)Use or Store the last macro defined or 
  1043.     used.  [To add a function key permanently to VDE.COM, use VINST: either 
  1044.     enter it again in VINST, or write it to a file and read the file into 
  1045.     VINST -- see DATA FILES.]
  1046.  
  1047.          EXAMPLES:  For clarity, macro examples will be given here as they 
  1048.     function, not as they are typed in; remember that you will need to add ^P 
  1049.     prefixes for certain control keys ([BkSp] (^H), [Enter] (^M), ^J, ^Y, ^P).  
  1050.     Keystrokes are often separated by spaces for clarity; the "_" symbol is 
  1051.     used to represent an actual space character typed.
  1052.             1.  Reformat an entire file: after Esc[, just enter
  1053.                                   ^B
  1054.          Specify Quiet and indefinite repeat as options ("Q,*").
  1055.             2.  View a file by scrolling slowly through it:
  1056.                           Esc; ^Z   or    Esc; ^C
  1057.          This pauses, then scrolls down.  (Again, repeat with "*".)
  1058.             3.  Re-load the current file, eliminating any changes 
  1059.          made since it was last saved:
  1060.                                ^KL ^F [Enter]
  1061.             4.  Macros are quite powerful.  Can you figure out what 
  1062.          this one does, if entered with indefinite repeat "*"?
  1063.                 ^QR ^QF(^J ^G ^KB ^QF)^J ^G ^KK ^QC [Enter] ^KV
  1064.          (It takes all phrases in parentheses out of a file, making 
  1065.          a list of them at the end of the file.)
  1066.  
  1067.          TECHNICAL NOTE: Ordinarily macros are completely self-contained, and 
  1068.     NEVER request input from the keyboard while executing.  There is one 
  1069.     exception: using AltR to run a program from a macro is tricky.  Input 
  1070.     while in the program or shell must be typed by you.  (VDE resumes control 
  1071.     only when the program ends; if the macro continues, its next keystroke 
  1072.     must be the [Esc] to return to editing.)
  1073.  
  1074. MACRO PROGRAMMING (^F,Esc;,Esc0..Z,Esc!,Esc=,~,<,>,Esc$,Esc(),Esc+,-,Esc&) - 
  1075.     VDE has several commands that operate only within a macro definition, and 
  1076.     give you conditional control over the execution of a macro, allowing real 
  1077.     programming.
  1078.          ^F, entered as part of an input string, will be replaced by the 
  1079.     current filename when the macro executes.  This can be useful to refer to 
  1080.     the current file when running compilers and file utilities.  Thus, if you 
  1081.     define the macro
  1082.                          AltR compile ^PF /g /r1 [Enter] Esc,
  1083.     the ^F embedded in the string will be expanded, so that the DOS command 
  1084.     executed by AltR will actually be something like
  1085.                          compile C:\PGM\MYPROG.C /g /r1.
  1086.          Esc; (Esc-semicolon) gives a brief pause before macro execution 
  1087.     continues, presumably so the user can see what's happening on screen.  Use 
  1088.     two or more to get a longer pause.
  1089.  
  1090.          Esc0...Z, when placed in a macro, function simply as local "labels" 
  1091.     0...Z.  They have no effect, but can be "jumped" to by other commands.
  1092.          Esc! followed by 0...Z is a "jump" instruction, causing macro 
  1093.     execution to resume with the command following that label.  Example: Esc!2 
  1094.     jumps to label 2.  As two special cases, Esc![ jumps to the beginning of 
  1095.     the macro, and Esc!] jumps to the end (exits).
  1096.  
  1097.          Esc= and Esc~ perform tests on the character at the current cursor 
  1098.     position.  There are two ways to use them:
  1099.               (1) Followed by a character, then a label 0...Z (or 
  1100.          "[","]" for start or end), they are conditional jumps: they 
  1101.          jump IF the character does (or for "~", does NOT) match the 
  1102.          one specified.  Example: Esc~^M2 jumps to label 2 if the 
  1103.          current character is NOT a CR.
  1104.              (2) Followed by a character, then ">" or "<", they are 
  1105.         search loops.  They will continue to move the cursor right 
  1106.         (or for "<", left) as long as the character at the cursor 
  1107.         does (or for "~", doesn't) match, or until the beginning or 
  1108.         end of the file.  Example: Esc=_> moves right as long as the 
  1109.         current character is a space (so it stops on a NONspace).
  1110.          Similarly, Esc< and Esc> test the cursor character's ASCII value and 
  1111.     act accordingly: thus Esc<A2 jumps to label 2 if the character is less 
  1112.     than ASCII "A" (41 hex), etc.
  1113.          (Note: place and block markers, since they are not part of the file 
  1114.     text, will fail any test.  If you need to check for their presence, you 
  1115.     can use Esc<^@ [00 hex, entered as ^P@] since no actual character could be 
  1116.     <0 and fail this test.)
  1117.  
  1118.          Normally, a macro halts when an error occurs.  With Esc$ you can 
  1119.     instead specify a label where execution should continue.  Thus, after the 
  1120.     command Esc$E, any command resulting in an error (like "not found") will 
  1121.     cause a jump to label E, ignoring the error.  You can also use the special 
  1122.     characters "[,]" to jump to the beginning or end of the macro, or "@" to 
  1123.     continue without taking action, or "$" to return to halting on any error.
  1124.          If you program an endless loop, you will at some point have to halt 
  1125.     execution of the macro by pressing Esc.
  1126.  
  1127.          Several commands allow the use of a counter variable.  Esc() sets the 
  1128.     value: for example, Esc(0) initializes it to zero.  The Esc+ command 
  1129.     simply increments the value; Esc- (minus) decrements the value, then jumps 
  1130.     if it is zero to a specified label.  (In addition to a number, you may use 
  1131.     "[" or "]" for the start or end, or "@" to avoid jumping entirely.)  
  1132.     Example: Esc-] decrements the counter, jumping to the end (exiting) if it 
  1133.     reaches zero; Esc-@ simply decrements it.
  1134.          Esc&, followed by a key identification like "!F1", is used to "chain" 
  1135.     to another function key.  Use "!,^,@" for Shift, Ctrl, Alt; and after the 
  1136.     "F", a single digit "1"-"9", or "A"-"C" for 10-12.  ("0" is also accepted 
  1137.     for F10.)  Example: "Esc&^FB" chains to Ctrl-F11.  Chaining lets you 
  1138.     organize macros more efficiently and conserve definition space.  This is a 
  1139.     "jump", not a "call"; there is no returning.
  1140.          The examples below will give some idea of how these commands can be 
  1141.     used to construct your own new VDE commands.  They will work faster if 
  1142.     you store them as Quiet keys, but in general, don't make macro programs 
  1143.     Quiet until you're sure they work.
  1144.  
  1145.          EXAMPLES: 1. Here is a good macro program (best stored as a Quiet 
  1146.     key) to move the cursor to the start of the current sentence:
  1147.     Esc~.1 ^S Esc1 Esc~.< ^D Esc=_2 Esc=^M2 ^S^S Esc!1 Esc2 ^D Esc=_2 Esc=^M2
  1148.          You could explain this in programmer's pseudo-code as:
  1149.               If not "." goto label1    ;move left if already on period
  1150.               Move left
  1151.      label1:  While not "." move left   ;move left to previous period
  1152.               Move right                ;move right to following character
  1153.               If " "  or ^M goto label2
  1154.               Move left twice           ;skip over a period if it's not
  1155.               Goto label1               ;  followed by a space or return
  1156.      label2:  Move right                ;okay, now move right as long
  1157.               If " " or ^M goto label2  ;  as you see a space or return
  1158.               (all done)
  1159.          2. This macro moves to the start of the current paragraph:
  1160.                           ^QS ^S^S Esc=_[ ^D^D
  1161.          3. If you have some text that you can't reformat because every line 
  1162.     ends in HARD CRs, here is a macro that will "soften up" one paragraph's 
  1163.     worth, leaving just one HARD CR at the end:
  1164.                    ^QS ^X Esc=_] Esc=^M] ^S_^D Esc![
  1165.          4. This macro moves to the center of the current line; note how the 
  1166.     counter variable is used to figure the line length, then move back only 
  1167.     halfway:   ^QS Esc(0) Esc1 Esc+ ^D Esc~^M1 Esc2 Esc-] Esc-] ^S Esc!2
  1168.          5. Many programming languages use nested sets of parentheses, for 
  1169.     example "{}" in C.  This macro, when the cursor is placed on an open 
  1170.     bracket "{", will move ahead to find the closed bracket "}" that matches 
  1171.     it:  Esc~{] Esc(0) Esc1 Esc~{2 Esc+ Esc!3 Esc2 Esc~}3 Esc-] Esc3 ^D Esc!1
  1172.  
  1173. TOGGLE CONTROL (Esc*) -  "Toggle" commands can create difficulties when used 
  1174.     in macro and function keys: ^V, for example, toggles insert mode.  But 
  1175.     when you plan a function key, you don't necessarily know how Insert will 
  1176.     be set when the key is used!  So if you use ^V in the macro, you don't 
  1177.     know whether you just turned it off or on; you might be overstriking or 
  1178.     inserting, and can't tell.
  1179.          The Esc* command provides a solution, by letting a macro specify an 
  1180.     exact state for each toggle.  Esc* must be followed by a LETTER to 
  1181.     identify a toggle, UPPERcase to turn it ON or LOWERcase to turn it OFF.  
  1182.     (Insert and Justify each have a third state, as well.)  For example, Esc*i 
  1183.     will set INSERT OFF, regardless of its previous state.  The toggles are:
  1184.               Autoindent     (^OA)  'a'=off  'A'=on
  1185.               Doublespace    (^OS)  'd'=off  'D'=on
  1186.               auto Format    (^OM)  'f'=off  'F'=on
  1187.               Hyphenation    (^OH)  'h'=off  'H'=on
  1188.               Insert         (^V)   'i'=off  'I'=on  'W'=word
  1189.               Justification  (^OJ)  'j'=off  'J'=on  'R'=remove
  1190.               Proportional   (^OK)  'p'=off  'P'=on
  1191.               Varitab        (^OV)  'v'=off  'V'=on
  1192.               margin release (^OX)  'x'=off  'X'=on
  1193.     Once you've used one of these you can revert to the usual commands (like 
  1194.     ^V), if you prefer, because you WILL now know the toggle setting.
  1195.  
  1196. RECORDING MACROS (Esc") - As an alternative to composing macros and using the 
  1197.     Esc[ command to type them in, you can simply record a macro as you go 
  1198.     about a task.  Press Esc" to activate recording; type away; then press 
  1199.     Esc" again to conclude.  You will then be asked whether to use or store 
  1200.     it, etc (see MACROS).  No confusing ^P prefixes are needed.  While 
  1201.     recording, a quote mark (") will be visible in the upper right (prefix) 
  1202.     area of the header, if the header is displayed.
  1203.          If you make an error while recording, use Esc" to stop recording, 
  1204.     press [Esc] at the prompt to quit, and start over.
  1205.          NOTES: Because macros don't nest, Function key commands themselves 
  1206.     (and also the "User" MenuBar) cannot be used while macro recording is in 
  1207.     progress.  Any other keystrokes can be recorded, including all other 
  1208.     MenuBar selections, and even PC keys like [PgUp] which cannot be entered 
  1209.     directly into a macro definition with the Esc[ command.  Be careful when 
  1210.     creating macros by recording [BkSp], [Del], [Home], [End]; the functions 
  1211.     of these keys are VINST options and may differ in someone else's copy of 
  1212.     VDE, so you may wish to use commands like ^S, ^G, ^QS, ^QD instead.
  1213.  
  1214.  
  1215. =====================  8. REVIEWS / ABOUT THE AUTHOR  ========================
  1216.  
  1217.  
  1218.                    A sampling of recent comments about VDE:
  1219.  
  1220.        "VDE is a word-processing program for people who like their 
  1221.     programs lean, mean and simple... executes all the standard 
  1222.     operations necessary for writing articles, books or screenplays... 
  1223.     blazingly fast... Even the loading and storing of files is speedy."     
  1224.               - Paul Ciotti, Los Angeles Times Magazine (18 March 1990)
  1225.  
  1226.        "This may be the finest piece of word processing code ever 
  1227.     written.  I have never been as impressed with anything as I have with 
  1228.     VDE 1.5... writing software in 100 percent assembly language still 
  1229.     pays off in performance and reduced code size.  It's an astonishing 
  1230.     product, believe me.  It's more than the perfect laptop word 
  1231.     processor.  Actually, it's something that corporations should 
  1232.     consider if they want to save tens of thousands of dollars...  I 
  1233.     cannot give a higher recommendation for any product that I have seen 
  1234.     in ten years than I can for VDE 1.5.  Top recommendation."
  1235.               - John Dvorak, PC Magazine (24 April 1990)
  1236.  
  1237.        "What fascinated Dvorak was not just the astonishing functionality 
  1238.     achieved with very little programming code, but also the attitude -- 
  1239.     and implications -- of the author who circulated it freely asking 
  1240.     only for a modest sum for site licenses...  VDE is an amazing word- 
  1241.     processor, offering almost everything except the layout and document 
  1242.     processing features found in far fatter programs... it supports the 
  1243.     old WordStar command set... ergonomically the most efficient I've 
  1244.     ever learned."
  1245.               - Colin Brace, Language Technology/Electric Word (July/Aug 1990)
  1246.  
  1247.        "I've used various versions of WordStar, WordPerfect, and Wang 
  1248.     IWP.  I wouldn't trade my copy of VDE for shrink-wrapped sets of the 
  1249.     latest versions of all of these.  I congratulate you both on the 
  1250.     quality of your program and on your policy in making it available to 
  1251.     people."  - K.N., registered VDE user (August 1991)
  1252.  
  1253.  
  1254.      As of Spring 1992, VDE can be found in "Dvorak's Top 30", a boxed 
  1255. collection of shareware applications published by Interplay Productions, 
  1256. available in retail stores.  It is also included on-disk with the book 
  1257. "Dvorak's Inside Track to DOS and PC Performance" by John Dvorak and Nick 
  1258. Anis, published by Osborne/McGraw-Hill.
  1259.  
  1260.  
  1261.                                ABOUT THE AUTHOR
  1262.  
  1263.      Eric Meyer has also written the shareware ZIP serial file transfer 
  1264. program and a number of free utilities for IBM PC compatibles.  He holds an 
  1265. A.B. in physics and a Ph.D. in history and philosophy of science, and has 
  1266. taught at the Universities of Indiana, Oklahoma, and Colorado.  A longtime 
  1267. advocate of microcomputers, he has done programming in HP-41, Z80 assembler, 
  1268. BASIC, FORTRAN, LISP, C, and APL; lately he has been working mostly in 8086 
  1269. assembler.  In a period of escalating software complexity and prices, he still 
  1270. believes that useful, inexpensive software should remain available to computer 
  1271. users worldwide.
  1272.  
  1273.  
  1274. ================================[end VDE.REF]=================================
  1275.